Documentacion: Estructura del sistema

Descripcion: El sistema multi agente consta de una o varias organizaciones que son del tipo descrito en este diagrama. La organizacion tiene entidades para la administracion de miembros de la comunidad, repositorios de documentos, gestion de agentes y clasificacion de documentos.

La entidad principal es el grupo Comunidad. Una comunidad consta de un Agente de Comunidad, de uno o varios Agentes Personales suscritos a la comunidad y de recursos para la gestion de los miembros de la comunidad.

Pueden existir un numero indeterminado de comunidades en la organizacion y no se restringe la pertenencia de un agente a una unica comunidad.

Una vez que un agente personal esta suscrito a un agente de comunidad, puede participar en los flujos de trabajo indicados. Es de mayor interes para el usuario el flujo de trabajo que le permite recibir documentos interesantes o enviar documentos que piense puedan gustar al resto de usuarios de la comunidad.

Instancias de entidades de meta-modelo

Entidad	Entidad del meta-modelo	Documentacion
Agente de Comunidad	Agente	Un agente de comunidad representa a un conjunto de usuarios con gustos en común. Se denomina perfil de la comunidad al conjunto de documentos que definen los gustos de los usuarios. Estos documentos provienen del bootstrapping de la comunidad (iniciación del proceso de aprendizaje) y de los documentos suministrados por los usuarios y reconocidos como interesantes por los demás.
Agente Personal	Agente	Un agente personal representa al usuario en el sistema. Se encarga de sustituirle y/o ayudarle en el proceso de filtrado colaborativo de la información. El agente se encarga de ir aprendiendo los documentos que interesan al usuario y asi ir mejorando en la evaluación autónoma de la información que llega a él.
AgenteExtractorNoticias	Agente	Agente encargado de introducir en comunidades informacion relevante de foros de noticias
AgenteRepresentante	Agente	Representa a una organizacion en el marco de interacciones entre organizaciones.
Base de datos	AplicacionEntorno	Base de datos utilizada en el sistema para la gestion de datos. Se reaprovechara para almacenar el estado del sistema
Servidor de Aplicaciones	AplicacionEntorno	Representa el servidor de aplicaciones donde se localiza los programas que hacen de interfaz con el usuario.
Clasificador	AplicacionInterna	Realiza labores de categorizacion de documentos. Este recurso admite la creacion, desctruccion y monitorizacion de categorias. Tambien permite la agregacion de nuevos documentos a una categoria existente y preguntar si un documento pertence a la categoria indicada.
GestorAgentes	AplicacionInterna	Permite a los agentes mantener un almacen de referencias a otros agentes. Este almacen hace posible obtener listas de los agentes existentes para que los agentes del sistema se puedan encontrar unos a otros
GestorEstadisticas	AplicacionInterna	Gestiona las estadisticas del agente. Las estadisticas es un conjunto de tuplas (clave,valor). La clave hace referencia a las posibles acciones que se quieren estudiar, mientras que el valor se concibe como un contador. El contador se incrementa cada vez que el agente ejecuta una accion.
GestorMiembrosComunidad	AplicacionInterna	Gestiona los miembros de una comunidad. Los miembros son basicamente referencias a id's de usuarios. Existe un repositorio donde los usuarios estan registrados y donde hay mas informacion indexada por el id del usuario.
Actividades de la comunidad	FlujoDeTrabajo	Las tareas de la comunidad se clasifican en dos grandes grupos. Por un lado las tareas dedicadas a la gestión de la comunidad (altas,bajas y monitorización), y por otro las dedicadas a ofrecer servicios a los usuarios. En el caso de estudio, se habla de intercambio de documentos.
compartir_documentos	FlujoDeTrabajo	Este flujo de trabajo especifica cuales son los pasos involucrados en la comparticion de documentos
Gestionar_comunidades	FlujoDeTrabajo	Este flujo de trabajo se descompone en otros flujos para la gestion de partes concretas de la comunidad: 1. Dar de alta/baja usuarios 2. Monitorizar usuarios 3. Echar a usuarios de la comunidadBR>
Administracion	Grupo	En el grupo de administración se encuentran los recursos utilizados por los agentes del sistema para: Localizar a otros agentes. No se trata solo de servicios de páginas blancas, sino también de servicios de páginas amarillas. Gestionar los documentos. El manejar documentos puede ser una tarea costosa debido a su gran tamaño. Por ello, se manejan referencias a documentos, mientras que los documentos en sí son almacenados por el gestor.
Comunidad	Grupo	Agrupa un agente de comunidad, un numero indeterminado de agentes personales, un clasificador y un gestor de estadisticas. Un agente de comunidad no puede pertenecer a otros grupos, pero un agente personal si que puede. Un Clasificador puede ser compartido por varios agentes de comunidad (ver descripcion del clasificador), sin embargo esta es una decision de implementacion que obedece a criterios de eficiencia (el proceso de clasificacion es costos en tiempo de CPU). El gestor de estadisticas y el de miembros son personales e intransferibles.
Distribuir_documentos_interesantes	Objetivo	Distribuir documentos que puedan interesar a otros usuarios
Mantener_calidad_documentos	Objetivo	La calidad de los documentos se refiere al grado de aceptacion de los documentos enviados. Cuantas menos evaluaciones negativas se obtengan, mejor.
Organizacion	Organizacion	La empresa es una organizacion que, entre otros servicios, ofrece la personalización de contenidos dentro un web en cuestión.

Agente de Comunidad (Agente)

Propiedades:

ID	Agente de Comunidad
Descripcion	Un agente de comunidad representa a un conjunto de usuarios con gustos en común. Se denomina perfil de la comunidad al conjunto de documentos que definen los gustos de los usuarios. Estos documentos provienen del bootstrapping de la comunidad (iniciación del proceso de aprendizaje) y de los documentos suministrados por los usuarios y reconocidos como interesantes por los demás.

Agente de Comunidad relaciones:

En el rol	En la relacion	Con los objetos	En el rol
OTieneAgente_destino	OTieneAgente	Comunidad	OTieneAgente_origen

Diagramas relacionados
Descripcion_CA

Agente Personal (Agente)

Propiedades:

ID	Agente Personal
Descripcion	Un agente personal representa al usuario en el sistema. Se encarga de sustituirle y/o ayudarle en el proceso de filtrado colaborativo de la información. El agente se encarga de ir aprendiendo los documentos que interesan al usuario y asi ir mejorando en la evaluación autónoma de la información que llega a él.

Agente Personal relaciones:

En el rol	En la relacion	Con los objetos	En el rol
OTieneAgente_destino	OTieneAgente	Comunidad	OTieneAgente_origen

Diagramas relacionados
Descripcion_PA

AgenteExtractorNoticias (Agente)

Propiedades:

ID	AgenteExtractorNoticias
Descripcion	Agente encargado de introducir en comunidades informacion relevante de foros de noticias

AgenteExtractorNoticias relaciones:

En el rol	En la relacion	Con los objetos	En el rol
OTieneAgente_destino	OTieneAgente	Comunidad	OTieneAgente_origen

AgenteRepresentante (Agente)

Propiedades:

ID	AgenteRepresentante
Descripcion	Representa a una organizacion en el marco de interacciones entre organizaciones.

AgenteRepresentante relaciones:

En el rol	En la relacion	Con los objetos	En el rol
OTieneAgente_destino	OTieneAgente	Administracion	OTieneAgente_origen

Base de datos (AplicacionEntorno)

Propiedades:

ID	Base de datos
Descripcion	Base de datos utilizada en el sistema para la gestion de datos. Se reaprovechara para almacenar el estado del sistema
Operaciones	guardarBytes recuperarBytes borrarBytes

Base de datos relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RRecurso	OTieneRecurso	Administracion	RGrupo

Servidor de Aplicaciones (AplicacionEntorno)

Propiedades:

ID	Servidor de Aplicaciones
Descripcion	Representa el servidor de aplicaciones donde se localiza los programas que hacen de interfaz con el usuario.
Operaciones	mostrar_documentos_recibidos usuario_evaluo_negativamente usuario_evaluo_positivamente usuario_reviso_documento usuario_sugirio_documento usuario_solicito_baja usuario_solicito_alta

Servidor de Aplicaciones relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RRecurso	OTieneRecurso	Administracion	RGrupo

Clasificador (AplicacionInterna)

Propiedades:

ID	Clasificador
Descripcion	Realiza labores de categorizacion de documentos. Este recurso admite la creacion, desctruccion y monitorizacion de categorias. Tambien permite la agregacion de nuevos documentos a una categoria existente y preguntar si un documento pertence a la categoria indicada.
Operaciones	nuevaCategoria borrarCategoria clasificarDocumentoEnCategoria obtenerListaCategorias obtenerCategoriaParaDocumento obtenerDocumentosDeCategoria preguntaCategoria agregarDocumentoCategoria quitarDocumentoCategoria

Clasificador relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RRecurso	OTieneRecurso	Comunidad	RGrupo

GestorAgentes (AplicacionInterna)

Propiedades:

ID	GestorAgentes
Descripcion	Permite a los agentes mantener un almacen de referencias a otros agentes. Este almacen hace posible obtener listas de los agentes existentes para que los agentes del sistema se puedan encontrar unos a otros
Operaciones	crearNuevoAgente destruirAgente obtenerListaAgentes

GestorAgentes relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RRecurso	OTieneRecurso	Administracion	RGrupo

GestorEstadisticas (AplicacionInterna)

Propiedades:

ID	GestorEstadisticas
Descripcion	Gestiona las estadisticas del agente. Las estadisticas es un conjunto de tuplas (clave,valor). La clave hace referencia a las posibles acciones que se quieren estudiar, mientras que el valor se concibe como un contador. El contador se incrementa cada vez que el agente ejecuta una accion.
Operaciones	agregaContador obtenContador dameListaContadores quitaContador

GestorEstadisticas relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RRecurso	OTieneRecurso	Comunidad	RGrupo

GestorMiembrosComunidad (AplicacionInterna)

Propiedades:

ID	GestorMiembrosComunidad
Descripcion	Gestiona los miembros de una comunidad. Los miembros son basicamente referencias a id's de usuarios. Existe un repositorio donde los usuarios estan registrados y donde hay mas informacion indexada por el id del usuario.
Operaciones	agregaMiembro dameMiembros quitaMiembro

GestorMiembrosComunidad relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RRecurso	OTieneRecurso	Comunidad	RGrupo

Actividades de la comunidad (FlujoDeTrabajo)

Propiedades:

ID	Actividades de la comunidad
Descripcion	Las tareas de la comunidad se clasifican en dos grandes grupos. Por un lado las tareas dedicadas a la gestión de la comunidad (altas,bajas y monitorización), y por otro las dedicadas a ofrecer servicios a los usuarios. En el caso de estudio, se habla de intercambio de documentos.

Actividades de la comunidad relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RFlujoTrabajo	OTieneFlujosTrabajo	Organizacion	ROrganizacion

RFlujoTrabajo	OTieneFlujosTrabajo	Gestionar_comunidades	RFlujoTrabajo

RFlujoTrabajo	OTieneFlujosTrabajo	compartir_documentos	RFlujoTrabajo

Diagramas relacionados
Descripcion, comparticion_documentos
Ejecucion de la propagacion de sugerencias
Ejecucion, altas en comunidad
Flujos de trabajo para gestionar comunidades

compartir_documentos (FlujoDeTrabajo)

Propiedades:

ID	compartir_documentos
Descripcion	Este flujo de trabajo especifica cuales son los pasos involucrados en la comparticion de documentos

compartir_documentos relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RFlujoTrabajo	OTieneFlujosTrabajo	Actividades de la comunidad	RFlujoTrabajo

Diagramas relacionados
Descripcion, comparticion_documentos

Gestionar_comunidades (FlujoDeTrabajo)

Propiedades:

ID	Gestionar_comunidades
Descripcion	Este flujo de trabajo se descompone en otros flujos para la gestion de partes concretas de la comunidad: 1. Dar de alta/baja usuarios 2. Monitorizar usuarios 3. Echar a usuarios de la comunidadBR>

Gestionar_comunidades relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RFlujoTrabajo	OTieneFlujosTrabajo	Actividades de la comunidad	RFlujoTrabajo

Diagramas relacionados
Ejecucion, altas en comunidad
Flujos de trabajo para gestionar comunidades

Administracion (Grupo)

Propiedades:

Administracion

Descripcion

En el grupo de administración se encuentran los recursos utilizados por los agentes del sistema para:

Localizar a otros agentes. No se trata solo de servicios de páginas blancas, sino también de servicios de páginas amarillas.

Gestionar los documentos. El manejar documentos puede ser una tarea costosa debido a su gran tamaño. Por ello, se manejan referencias a documentos, mientras que los documentos en sí son almacenados por el gestor.

Administracion relaciones:

En el rol	En la relacion	Con los objetos	En el rol
ODescomposicionGrupos_destino	OTieneGrupo	Organizacion	OTiene_grupo_origen

OTieneAgente_origen	OTieneAgente	AgenteRepresentante	OTieneAgente_destino

RGrupo	OTieneRecurso	Servidor de Aplicaciones	RRecurso

RGrupo	OTieneRecurso	Base de datos	RRecurso

RGrupo	OTieneRecurso	GestorAgentes	RRecurso

Comunidad (Grupo)

Propiedades:

Comunidad

Descripcion

Agrupa un agente de comunidad, un numero indeterminado de agentes personales, un clasificador y un gestor de estadisticas. Un agente de comunidad no puede pertenecer a otros grupos, pero un agente personal si que puede. Un Clasificador puede ser compartido por varios agentes de comunidad (ver descripcion del clasificador), sin embargo esta es una decision de implementacion que obedece a criterios de eficiencia (el proceso de clasificacion es costos en tiempo de CPU). El gestor de estadisticas y el de miembros son personales e intransferibles.

Comunidad relaciones:

En el rol	En la relacion	Con los objetos	En el rol
ODescomposicionGrupos_destino	OTieneGrupo	Organizacion	OTiene_grupo_origen

OTieneAgente_origen	OTieneAgente	Agente Personal	OTieneAgente_destino

OTieneAgente_origen	OTieneAgente	AgenteExtractorNoticias	OTieneAgente_destino

OTieneAgente_origen	OTieneAgente	Agente de Comunidad	OTieneAgente_destino

RGrupo	OTieneRecurso	Clasificador	RRecurso

RGrupo	OTieneRecurso	GestorEstadisticas	RRecurso

RGrupo	OTieneRecurso	GestorMiembrosComunidad	RRecurso

Distribuir_documentos_interesantes (Objetivo)

Propiedades:

ID	Distribuir_documentos_interesantes
Descripcion	Distribuir documentos que puedan interesar a otros usuarios
estado

Distribuir_documentos_interesantes relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RObjetivo	EntidadAutonomaTieneObjetivos	Organizacion	REntidadAutonoma

Mantener_calidad_documentos (Objetivo)

Propiedades:

ID	Mantener_calidad_documentos
Descripcion	La calidad de los documentos se refiere al grado de aceptacion de los documentos enviados. Cuantas menos evaluaciones negativas se obtengan, mejor.
estado

Mantener_calidad_documentos relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RObjetivo	EntidadAutonomaTieneObjetivos	Organizacion	REntidadAutonoma

Organizacion (Organizacion)

Propiedades:

ID	Empresa
Descripcion	La empresa es una organizacion que, entre otros servicios, ofrece la personalización de contenidos dentro un web en cuestión.

Organizacion relaciones:

En el rol	En la relacion	Con los objetos	En el rol
OTiene_grupo_origen	OTieneGrupo	Administracion	ODescomposicionGrupos_destino

OTiene_grupo_origen	OTieneGrupo	Comunidad	ODescomposicionGrupos_destino

REntidadAutonoma	EntidadAutonomaTieneObjetivos	Mantener_calidad_documentos	RObjetivo

REntidadAutonoma	EntidadAutonomaTieneObjetivos	Distribuir_documentos_interesantes	RObjetivo

ROrganizacion	OTieneFlujosTrabajo	Actividades de la comunidad	RFlujoTrabajo